Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 2 - Control Manager Reference / Control Manager Functions

Manipulating Controls /

ActivateControl

NEW WITH THE APPEARANCE MANAGER

Activates a control and any latent embedded controls.

pascal OSErr ActivateControl (ControlHandle inControl);

inControl

On input, a handle to a control that you wish to activate. Passing a window's root control will activate all controls in that window.

function result

A result code; see "Result Codes".

DISCUSSION

The ActivateControl function should be called instead of HiliteControl to activate a specified control and its latent embedded controls. For a discussion of latency, see "Manipulating Controls".

You can use ActivateControl to activate all controls in a window by passing the window's root control in the inControl parameter.

If a control definition function supports activate events, it will receive a kControlMsgActivate message before redrawing itself in its active state.

SEE ALSO

DeactivateControl.

"Embedding Controls".

"Appearance Manager Gestalt Selector Constants".